home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / fgl303a.zip / WHATS.NEW < prev   
Text File  |  1993-10-02  |  43KB  |  785 lines
  1.  
  2.                                 Release Notes
  3.  
  4.                              Fastgraph (tm) V3.0
  5.  
  6.  
  7.  
  8.                              Ted Gruber Software
  9.                                  PO Box 13408
  10.                              Las Vegas, NV  89112
  11.  
  12.                              (702) 735-1980 voice
  13.                               (702) 735-4603 FAX
  14.                               (702) 796-7134 BBS
  15.                                 72000,1642 CIS
  16.  
  17.                  Copyright (c) 1991-1993 Ted Gruber Software.
  18.                              All Rights Reserved.
  19.  
  20.  
  21. ------------------------------------------------------------------------------
  22.                                  Introduction
  23. ------------------------------------------------------------------------------
  24.  
  25. The Fastgraph 3.0 release notes describe the new features added in Fastgraph
  26. 3.00 through 3.03 (hereafter collectively referred to as Fastgraph 3.0).  The
  27. release notes will be of interest to customers who are already familiar with
  28. Fastgraph so they can get an overview of the new version.  Among the many new
  29. features in Fastgraph 3.0 are:
  30.  
  31. * SVGA support for 19 chipsets plus VESA in resolutions of 640x400x256,
  32.   640x480x256, 800x600x256, 1024x768x256, 800x600x16, and 1024x768x16.
  33. * Routines for displaying and creating GIF files (not in Fastgraph/Light).
  34. * Routines for FAST filling of convex polygons, with clipping.
  35. * Low-level keyboard handler, ideal for game development.
  36. * User-definable image buffer (up to 64K) for faster creation and display
  37.   of GIF, PCX, and pixel run files.
  38. * Additional graphics primitives, including XOR points/lines/boxes in all
  39.   graphics modes, filled circles and ellipses, and clipped region fill.
  40. * Bit maps that don't include transparent colors.
  41. * Block transfers between RAM and video memory instead of just video memory
  42.   to video memory.
  43. * Improved ROM text support, including three font sizes (VGA/SVGA) and the
  44.   ability to display strings relative to any graphics position.
  45. * Ability to access up to 1MB video RAM in non-SVGA modes with certain SVGA
  46.   chipsets (see the READ.ME file for more information about this).
  47. * Ability to display PCX images at the position defined in the PCX header
  48.   instead of only relative to the current graphics position.
  49. * Total of 47 new functions.
  50. * Support for additional compilers.
  51.  
  52. The release notes provide an overview of most of these new features.  For
  53. details, refer to the Fastgraph User's Guide and Reference Manual.
  54.  
  55. Please be sure to see the last section of this document, which discusses two
  56. important compatibility considerations when migrating Fastgraph 2.xx programs
  57. to version 3.0.
  58.  
  59. ------------------------------------------------------------------------------
  60.                    Summary of New Routines in Fastgraph 3.0
  61. ------------------------------------------------------------------------------
  62.  
  63. The following routines are new to Fastgraph 3.0.  Please see the Fastgraph
  64. Reference Manual for full descriptions, including their parameters, return
  65. values, and restrictions.
  66.  
  67. FG_BOXW      World space version of FG_BOX
  68. FG_BOXX      Draw hollow rectangle in XOR mode
  69. FG_BOXXW     World space version of FG_BOXX
  70. FG_CIRCLEF   Draw a filled circle
  71. FG_CIRCLEFW  World space version of FG_CIRCLEF
  72. FG_DEFPAGES  Define extended video pages when using block transfer routines
  73. FG_DRAWRELX  Draw line in XOR mode relative to graphics position
  74. FG_DRAWRXW   World space version of FG_DRAWRELX
  75. FG_DRAWX     Draw line in XOR mode
  76. FG_DRAWXW    World space version of FG_DRAWX
  77. FG_ELLIPSEF  Draw a filled ellipse
  78. FG_ELLIPSFW  World space version of FG_ELLIPSEF
  79. FG_FILLPAGE  Fill active video page with the current color
  80. FG_FLOOD     Like FG_PAINT but observes the clipping limits
  81. FG_FLOODW    World space version of FG_FLOOD
  82. FG_FONTSIZE  Enable 8x8, 8x14, or 8x16 ROM font (VGA/SVGA only)
  83. FG_GETBLOCK  Transfer rectangular region from video memory to RAM
  84. FG_GETENTRY  Get address and type of a physical, virtual, or logical page
  85. FG_IMAGEBUF  Define address and size of Fastgraph's GIF/PCX file buffer
  86. FG_INSIDE    Check if a specified point is inside a convex polygon
  87. FG_JUSTIFY   Define justification settings for FG_PRINT
  88. FG_KBINIT    Enable or disable the Fastgraph low-level keyboard handler
  89. FG_KBTEST    Determine if a key is now pressed or released
  90. FG_MAKEGIF   Create GIF file from rectangular region of active video page
  91. FG_MAKEPPR   Create PPR file from rectangular region of active video page
  92. FG_MAKESPR   Create SPR file from rectangular region of active video page
  93. FG_MEMORY    Return amount of video memory present in kilobytes
  94. FG_MOUSEFIN  Unhook Fastgraph's XVGA or SVGA mouse handler
  95. FG_PAGESIZE  Return video page size in bytes
  96. FG_POINTX    Draw point in XOR mode
  97. FG_POINTXW   World space version of FG_POINTX
  98. FG_POLYFILL  Draw filled convex polygon
  99. FG_POLYLINE  Draw unfilled polygon from one vertex array
  100. FG_POLYOFF   Define polygon offsets for FG_POLYFILL and FG_POLYLINE
  101. FG_PRINT     Display hardware characters in screen space
  102. FG_PUTBLOCK  Transfer rectangular region from RAM to video memory
  103. FG_PUTIMAGE  Like FG_DRWIMAGE but doesn't check for transparent pixels
  104. FG_SETENTRY  Set address and type of a physical, virtual, or logical page
  105. FG_SHOWGIF   Display GIF file
  106. FG_SHOWPCX   Display PCX file (formerly FG_DISPPCX)
  107. FG_SHOWPPR   Display packed pixel run (PPR) file
  108. FG_SHOWSPR   Display standard pixel run (SPR) file
  109. FG_SVGAINIT  Initialize Fastgraph's SVGA kernel
  110. FG_SVGASTAT  Return information about the active SVGA chipset
  111. FG_SVGAVER   Return Fastgraph SVGA kernel version number
  112. FG_TCDEFINE  Define transparent color number for FG_TCXFER
  113. FG_WAITVR    Specify if functions wait internally for vertical retrace
  114.  
  115. Note that FG_MAKEGIF, FG_SHOWGIF, and the world space functions are not in
  116. Fastgraph/Light.
  117.  
  118. ------------------------------------------------------------------------------
  119.                              New SVGA Video Modes
  120. ------------------------------------------------------------------------------
  121.  
  122. Six new video modes have been introduced for Fastgraph's SVGA support.  These
  123. are summarized below:
  124.  
  125.         640x400x256   mode 24         1024x768x256   mode 27
  126.         640x480x256   mode 25         800x600x16     mode 28
  127.         800x600x256   mode 26         1024x768x16    mode 29
  128.  
  129. Before you establish an SVGA graphics mode with FG_SETMODE, you must call the
  130. FG_SVGAINIT function.  This new function initializes Fastgraph's SVGA kernel
  131. for a specific SVGA chipset (see the list of supported chipsets in the next
  132. section).  You can use FG_SVGAINIT to automatically detect the system's SVGA
  133. chipset, or you can use a specific chipset.
  134.  
  135. More information about the new SVGA video modes, Fastgraph's SVGA kernel, and
  136. the FG_SVGAINIT routine appears in Chapters 2 and 3 of the Fastgraph User's
  137. Guide.
  138.  
  139. ------------------------------------------------------------------------------
  140.                            Supported SVGA Chipsets
  141. ------------------------------------------------------------------------------
  142.  
  143. As different manufacturers developed SVGA cards, they implemented the SVGA
  144. features according to their own specifications (each unique implementation is
  145. called a "chipset").  This situation arose because of the lack of an SVGA
  146. standard.  Fastgraph 3.0 will directly support the SVGA chipsets listed in
  147. the table below.  A "Y" entry means the chipset supports the video mode, and
  148. an "N" means it doesn't.  The last row of the table shows the amount of video
  149. memory required to support each mode.
  150.  
  151.                         ----------- 256 colors ------------  --- 16 colors ---
  152. SVGA chipset            640x400  640x480  800x600  1024x768  800x600  1024x768
  153. ==============================================================================
  154. Ahead "A" type             Y        Y        Y         N        Y         Y
  155. ------------------------------------------------------------------------------
  156. Ahead "B" type             Y        Y        Y         Y        Y         Y
  157. ------------------------------------------------------------------------------